home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmidstr.z / pmidstr
Text File  |  1997-04-03  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMIIIIDDDDSSSSTTTTRRRR((((3333))))                                                          PPPPMMMMIIIIDDDDSSSSTTTTRRRR((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmIIIIDDDDSSSSttttrrrr - convert a performance metric identifier into a string
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      cccchhhhaaaarrrr ****ppppmmmmIIIIDDDDSSSSttttrrrr((((ppppmmmmIIIIDDDD ppppmmmmiiiidddd))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      For use in error and diagnostic messages, return a `human readable'
  20.      version of the specified Performance Metric Identifier (PMID).
  21.  
  22.      Internally, a PMID is encoded as follows;
  23.  
  24.           typedef struct {
  25.               int             pad:2;
  26.               unsigned int    domain:8;
  27.               unsigned int    cluster:12;
  28.               unsigned int    item:10;
  29.           } _pmID_int;
  30.  
  31.      ppppmmmmIIIIDDDDSSSSttttrrrr returns a string with each of the _d_o_m_a_i_n, _c_l_u_s_t_e_r and _i_t_e_m
  32.      subfields appearing as decimal numbers, separated by periods.
  33.  
  34.      The string value is held in a single static buffer, so the returned value
  35.      is only valid until the next call to ppppmmmmIIIIDDDDSSSSttttrrrr.
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmIIIInnnnDDDDoooommmmSSSSttttrrrr(3) and ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3).
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.